ilbmtoppm

NAME

SYNOPSIS

DESCRIPTION

Normal ILBMs

1-8 planes with or without colormap, or 9-16 planes with colormap. If no colormap is present, ilbmtoppm interprets the pixel values as intensity (grayscale) values. Amiga display modes Extra_Halfbrite (EHB) and Hold-and-modify (HAM) are supported, and the multiplatte formats Palette Change (PCHG chunk), Dynamic HAM/Hires (CTBL chunk) and Sliced HAM (SHAM chunk). HAM images are limited to 3-10 planes.

Deep ILBMs

9, 12 or 15 planes without colormap, or 18-48 planes (the number of planes must be divisible by 3). Most deep ILBMs have 24 planes (for 8-bit RGB values).

Direct color ILBMs

3-48 planes, no colormap, DCOL chunk. This is an experimental format that supports a different number of planes for each color component.

Colormap files

BMHD + CMAP chunk only, 0 planes.

IFF-RGBN and IFF-RGB8 files

4 or 8-bit RGB values, genlock (transparency) bits Compressed using a pixel repeat count. Uses the same chunks as IFF-ILBM.

IFF-PBM files

Uses chunky 8-bit pixels in the BODY chunk, otherwise the same as colormapped IFF-ILBMs.

Chunks used:

BMHD, CMAP, CMYK, CLUT, CAMG, DCOL, PCHG, CTBL, SHAM, BODY

Chunks ignored:

GRAB, DEST, SPRT, CRNG, CCRT, DYCP, DPPV, DRNG, EPSF, JUNK, CNAM, PRVW

Other chunks (ignored but displayed in verbose mode):

ANNO, AUTH, (c), DPI, FVER, NAME, TEXT

Unknown chunks are skipped.

OPTIONS

-verbose (*)

Give some information about the input file.

-ignore chunkID

Skip a chunk. chunkID is the 4-letter IFF chunk identifier of the chunk to be skipped. This option can appear more than once on the command line.

-isham | -isehb

Treat the input file as a HAM or EHB picture, even if these flags or not set in the CAMG chunk (or if there is no CAMG chunk). This option has no effect with RGBN/RGB8 and IFF-PBM pictures.

-isnotham | -isnotehb

Do not treat the input file as a HAM or EHB picture, even if these flags are set in the CAMG chunk. This option has no effect with RGBN/RGB8 and IFF-PBM pictures.

-isdeep

Treat an input file with less than 16 planes as a deep ILBM, even if it provides a colormap. The number of planes in the input file must be divisible by 3. This option has no effect with RGBN/RGB8 and IFF-PBM pictures.

-isnotdeep

Do not treat an input file as a deep ILBM, even if it has more than 8 planes and/or no colormap. This option has no effect with RGBN/RGB8 and IFF-PBM pictures.

-adjustcolors (*)

Scale a 4-bit colormap or shifted 4-bit colormap to 8 bits. If this option is not used and ilbmtoppm believes that the colormap consists of 4-bit values or shifted 4-bit values, it prints a warning. This option has no effect with RGBN and RGB8 pictures.

-cmaponly

Extract only the colormap from the input file. The resulting PPM file will be in P3 ASCII format. This option results in an error if used with a RGBN or RGB8 file.

-transparent color

Write transparent pixels in color instead of their colormap entry. The color is specified as in ppmmake(1).

-maskfile filename

Generate a mask file from a mask plane (ILBM) or transparent color entry (ILBM and IFF-PBM), or genlock bits (RGBN/RGB8) and write it to filename. This is a normal PBM image, the same size as the PPM output file. A pixel value of PBM_WHITE in the mask file means the corresponding in the output file is considered to be transparent, PBM_BLACK indicates an opaque pixel (think of the output file casting a shadow on a white screen).

BUGS

REFERENCES

SEE ALSO

AUTHORS

Index

NAME

SYNOPSIS

DESCRIPTION

OPTIONS

BUGS

REFERENCES

SEE ALSO

AUTHORS